home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr31
/
simpback.zip
/
SIMPBACK.DOC
< prev
next >
Wrap
Text File
|
1993-04-19
|
31KB
|
903 lines
Thrifty Applications
Simple Backup
Version 2.1
Copyright (c) 1990-92 by Thrifty Applications
All Rights Reserved.
This documentation and program software protected by copyright.
Thrifty Applications reserves all rights to its contents.
This program is distributed as a shareware program. Feel free to
share it with your friends, but don't give it away altered or as
part of another system. If you find this program useful, you
should register the product.
Register Simple Backup for $25.00, or save $15.00 and get
Simple Backup and Simple Dos, a directory interface system
for $35.00. Registered users receive the latest reminder-free
version, printed documentation and six months phone support.
Send your check or credit card information to:
Thrifty Applications
P.O Box 5603
Hopkins, MN 55343 USA
LIMITED WARRANTY
Simple Backup is provided "as-is" and without warranty of any kind.
We disclaim any and all other warranties, express or implied,
oral or written, including any implied warranties of
merchantability or fitness for a particular purpose.
LIMITATION OF LIABILITY
In no event shall Thrifty Applications be liable for any
incidental, consequential, or punitive damages whatsoever arising
out of use of the program or your relationship with us, including
without limitation any or all damages for loss of profits, business
interruption, loss of information or any pecuniary loss.
This statement shall be governed by the laws of the State of
Minnesota, U.S.A..
PROBLEM RESOLUTION
Thrifty Applications is a member of the Association
of Shareware Professionals (ASP). ASP wants to make sure
that the shareware principle works for you. If you are
unable to resolve a shareware-related problem with an
ASP member by contacting the member directly, ASP may
be able to help. The ASP Ombudsman can help you resolve
a dispute or problem with an ASP member, but does not provide
technical support for members' products. Please write to the
ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a
CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536.
Table of Contents
-----------------
Introduction 1
Backup Operation 2
Function Key Options 3
File Compression 4
Backup Status 5
Script File 5
Restore Operation 8
Command Line Parameters 8
Function Key Options 9
Emergency Restore 10
Error Handling 11
Help System 15
Language File 15
Technical Support 15
Simple Backup is a file backup and restore system. It is made
up of 3 separate EXE files: 1) File Backup, 2) Restore, and
3) Script File Creation. The Simple Backup has a complete help
system, just press F1 for help. These programs have been used
since 1990. The backup utility works quite nice for backing up
specific work drives or directories.
Features:
- Supports floppy disks, hard disks and network backups.
- Compresses files 40 - 80% or more.
- Automatically formats floppy disks.
- Split files across multiple floppy disks.
- Uses all disk space.
- Backup multiple drive\directory in a single pass.
- Built in Help system.
- Script files support for automating backup operations for users.
- Message customization for international support and special
needs.
Files:
SIMPBACK.EXE - Thrifty Applications Backup Program
SIMPREST.EXE - Thrifty Applications Restore Program
SIMPBACK.HLP - Backup Help File
SIMPREST.HLP - Restore Help File
SIMPNBACK.LNG - Screen Text Message File
MAKESCRP.EXE - Script File Editor
MAKESCRP.HLP - Script Help File
SIMPBACK.DOC - Documentation File - This File
ORDER.DOC - Order File
The SIMPBACK.LNG file must be on the system drive to run the
SIMPBACK.EXE or SIMPREST.EXE programs. If this file is not in
the current directory a search of all drive will begin starting
with C:\. If the file is not found, an error is returned.
Page 1
Backup Operations
All backup parameters can be set under user control or passed to
the backup program through a script file to allow for minimum user
intervention. The script file must be used when backing up
multiple file specifications in a single pass. Optionally, the
script file can set the default parameters and the user can
override parameters or continue processing.
Command Line Syntax's
Start Simple Backup using default settings.
SIMPBACK
Start Simple Backup designating source path and\or filespec using
default settings.
SIMPBACK 'source path\filespec' B
Start Simple Backup with settings specified in script file
SIMPBACK 'script file name' S
Backup Organization
Backup files are placed on the backup disk with the same directory
structure and file name as the original file. A new directory is
created showing the source drive. DOS directories are limited to
63 characters. Simple Backup adds a minimum of 2 characters to your
directory name (the drive letter and backslash). Therefore,
Simple Backup can only backup files in directories with names of 61
characters or less. This limit may be more severe when backing up
to a directory on your hard disk.
Compressed files have the same name as the original except for a
unique extension. There is a header file placed in the target
directory that provides information on the backup.
Preforming Backups
Take the following steps after starting SIMPBACK to backup your files.
1) Verify options and change as needed. The options are:
- The target drive - A: is the default
- Verify status - the default is on.
- Date Range - the default is unlimited.
- File Compression - the default is off.
- Disk Size - the default is the largest for a specified drive.
- Script file name - the default is none.
- Hard Disk Target - (when applicable) there is no default.
2) Press 'C' to begin the backup process.
Page 2
3) Enter the source directory path and file specifications from
which files originate. The path must be valid. The default
file specification is all files (*.*). DOS wildcard symbols
are accepted here. This prompt is bypassed when specified in
a script file.
4) Verify disks are ready by pressing 'C'. A window displays the
estimated number of disks needed for the archived files
according to disk capacity. The actual number of disks could
be different when bad sectors exist or compression is used.
Always have extra disks handy.
5) The backup process then starts. If the current disk fills,
backup files may be split across multiple disks; and you are
prompted to insert a new disk each time.
6) You may end the backup procedure by pressing 'Esc' and 'C'.
An error window will declare that an error occurred during
backup. The backup disk(s) may contain partial files and
corrupt information. You should correct the backup disks
immediately.
7) If a target disk contains files, a prompt displays and you
must choose an action. You can erase this disk only, insert
a new disk, abort, or delete files on all disks. If a backup
disk is not formatted, a prompt displays and you must choose
an action. You can format this disk only, insert a new disk,
abort, or format all disks. Disk erasure and formatting are
controlled separately.
Backup Function Keys
F3 Select Target Drive
Select the destination drive that files will be backed up to.
Pressing F3 will "rotate" through the available drives on the
system. Press F3 repeatedly until the desired drive is displayed.
Drives other than floppy drives will require the use of F9 to enter
the backup target path. Floppy drives will always backup to the
root directory.
F4 Verify Option
If verify is on, all files are verified as they are copied to the
destination floppy. The backup process is slower, but data
integrity is verified. We recommended that you set this option ON.
Use the F4 key to toggle verify On or Off.
F5 Date filter
If a date filter is entered, only files with date stamps equal to
or greater than the date filter are included in the backup. The
date filter may be used with the file specification field to
further filter files for backup.
Page 3
F6 Select Disk Size
Select the disk size to be used when the target drive is a floppy
drive. Pressing F6 will toggle between the two valid disk sizes for
that drive. F6 has no effect on 360K floppy drives. The size
selected is used in formatting the disk and estimating the number
of disks required for the backup.
F7 Toggle File Compression
Pressing F7 will toggle the file compression mode. When file
compression is ON, a proprietary method of file compression will be
applied to each file backed up. This file compression will result
in a savings of about 50% in the disk space required by the backup.
Files that are smaller than one cluster and files that do not yield
any space savings in the first 8K will be copied without
compression.
F8 Load a Script File
Pressing F8 will allow you to load a script file to control the
backup process. After pressing F8 you will be prompted to enter the
path and file name of the script file you want to load. Default
path and file extension will be added if omitted, however you must
provide at least the 8 character file name. If the script file
contains the /NON switch, the user will immediately be prompted for
the first backup disk and the backup will start.
F9 Enter Backup Target Path
Press F9 to enter the backup target path when the target drive is
any drive other than a floppy drive. If the target drive is NOT a
floppy drive, then the target path MUST be entered before the
backup can proceed. This is because the backup cannot be made to
the root directory on a hard disk or network drive. If the target
path is specified by the /B switch in a script file that is loaded,
then the user is not required to enter the target path.
File Compression
Compressed files have the same name as the original except for a
unique extension. Only one file is contained in each compressed
file. This allows for easier selection for restore and reduced
potential for corruption. Files are only compressed when they are
larger than one cluster. DOS always allocates a minimum of one
cluster to a file. Sector size is normally 512 or 1,024 bytes.
Files are also only compressed when a saving results. Therefore,
files compressed by other compression programs normally will not be
compressed. When compression is selected, it is possible to have
a mixture of compressed and uncompressed files.
Page 4
Typical compression savings for files are as follows:
.EXE & .OBJ files 20-35%
Text files 50-60%
Data and Key files 60-80%
Backup Status
The statistics window (see figure 1) has information on the current
status of the backup. The first entry is the date and time of the
backup. Bytes Total is the total bytes to be archived. Bytes
Archived and % Archived are the total bytes and percentage
currently completed. % Space Saved shows the amount of space saved
through compressions. The next entry displays the current disk and
the total number of disks. If a backup disk contains subdirectory
or bad sectors, then the total disk count may be miscalculated and
display as '??'. Verify, File Compression and Backup To Hard Drive
show the status of these settings. Files Total is the total number
of files to be archived.
┌───────────────────────────────────┐
│ 16 SEP 14:35:53 199x │
│ ────────────────────────────── │
│ Bytes Total: 1,345,640 │
│ Bytes Archived: 33,556 │
│ % Archived: 2% │
│ % Space Saved: 55% │
│ Disk 1 Of 1 │
│ Verify: Off │
│ Files Total: 8 │
│ File Compression: On │
│ Target Drive: B: │
│ Backup To Hard Drive: No │
│ Disk Size: 1.4M │
└───────────────────────────────────┘
Figure 1
Backup Script File
The script file is a standard ASCII file with the following format:
<switch><parameter>.
Uppercase and lowercase are both acceptable. Different parameters
are used for the restore.
<switch> is a slash character (/) followed by an alpha character.
<parameter> immediately follows the switch with NO spaces.
Page 5
Switch Description
/B Target Drive and path. Path is allowed only when the
destination is a hard drive. If the path does not exist, it
will be created. If the path contains any files , including
subdirectories below the given path, they are erased after
prompting the user
Values: Any valid DOS drive and path specification
Default: /BA:\
Examples: /BA:\ /BB:\ /BE:\BACKUPS
/C Use file compression. Files are compressed using a
proprietary compression scheme that normally saves 50% of the
disk space.
Values: ON OFF
Default: /COFF
Examples: /CON /COFF
/D Date filter. Selects only files with dates greater than or
equal this date.
Values: MM/DD/YY
Default: None
Examples: /D08/01/91
/E Erase options. Affect processing when files are encountered
on the target drive.
Values: ALL PROMPT
Default: /EPROMPT
Examples: /EALL /EPROMPT
Page 6
/F Format options. Affect processing when an unformatted disk is
encountered.
Values: ALL PROMPT
Default: /FPROMPT
Examples: /FALL /FPROMPT
/I Include files in backup. All files matching the path and
wildcard combination will be archived. 1 to 25 different
parameters must be specified on separate lines. All three
components are required: drive, path, and file specification.
Values: Any DOS Drive, path and file specification.
Default: None
Examples: /IE:\DATABASE\*.DAT /IC:\*.BAT
/N Nonstop Flag. Allows user to change parameters before
beginning the archive.
Values: ON OFF
Default: /NOFF
Examples: /NON /NOFF
/S Disk size to be used for backup. Only valid for floppy disks,
not for hard disk.
Values: 360K, 720K, 1.2M, 1.4M
Default: Highest density on drive
Examples: /S360K /S720K /S1.2M /S1.4M
/V Set verify. Verify checks file integrity, but degrades
performance.
Values: ON OFF
Default: /VOFF
Example: /VON /VOFF
Page 7
/X Exclude files. All files matching a drive, path and
wildcard/file specification are excluded from the archive. It
works in conjunction with the /I switch. /X has precedence
over /I. Up to 25 different parameters may be specified on
separate lines. File specification must be given. If drive or
path are omitted, then files from all includes are compared to
the file specification.
Values: Any DOS drive, path, and file specification.
Default: None
Examples: /XE:\DATABASE\*.OLD /XC:*.BAK
Restore Operations
The restore process can only be done as a complete restore, at this
time a partial or selective restore in not an option. The restore
process can be passed optional switches to simplify user
intervention.
Restore Parameters
Below is the format to use in calling the RESTORE function.
Syntax : RESTORE(<source path>,<option switches>)
<option switches>
A string with any number of parameters. Parameters must not be
separated by spaces. Each parameter has the format /<switch>
<param>.
<source path>
The source drive and path for files restored. The default is
"A:\".
Switch Description
/N Nonstop switch. Transparent mode bypasses the initial options
screen. The user cannot access the initial options screen,
even when invalid parameters or error conditions exist. All
files are restored to their original source drive and
directory. Other switches must be set to determine the source
drive and overwrite options.
Values: ON OFF
Default: /NOFF
Examples: /NON /NOFF
Page 8
/V Set Verify. File verification is slower. It turns DOS verify
on or off.
Values: ON OFF
Default: /VOFF
Examples: /VON /VOFF
/O Overwrite options. This parameter controls processing when
files exist on the target directory.
Values: PROMPT - prompts for overwrite and skip options.
OVER - overwrite all files that already exist.
SKIP - skips all files that already exist.
Default: /OPROMPT
Examples: /OPROMPT /OOVER /OSKIP
Restore Function Key Options
F3 Select Drive
Pressing F3 will "rotate" trough a list of available drives on the
system. The drive selected must be the drive which the backup was
made that is going to be restored. In the event that a drive other
than a floppy drive is selected, The user must then use F5 to enter
the path that the backup was made to.
F4 Verify Option
If this option is enabled, all files restored will be verified as
they are copied to the destination disk. The restore process is
slower, but data integrity is verified. We recommended that you set
this option ON. Use the F4 key to toggle verify ON or OFF.
F5 Restore From Source Path
Pressing F5 will open a window from which you will enter the source
path from which the restore will be performed if the source drive
is a hard drive or a network drive. This path would be the same
path you specified as the target path for the backup.
Page 9
Perform the following steps to restore your files:
1) Verify default options. The program initially uses A: as the
source drive, and verify is set to off. Press 'F3' to toggle
the source drive. Press 'F4' to toggle file verification.
Restore speed is slowed by verification, but data integrity is
verified. Press 'F5' to specify source path when source drive
is hard drive or network drive. Press 'C' to continue.
2) Insert the disk to restore from. Press 'C' to continue.
3) Enter the path to restore to. The source drive displays as
the default. You can accept this or change the destination
path. Press 'Enter' to continue.
4) The restore process then starts. If the original backup
spanned multiple disks, you are prompted to insert a new disk
as each disk is completely restored.
5) If any matching files are discovered in the destination
directory, you are prompted to take action. You can overwrite
the current file, overwrite all matching files, skip one file,
skip all matching files, or abort. If 'Esc' is accidentally
pressed, you may continue the restore with no data loss.
6) You may end the restore procedure by pressing 'Esc' and 'A'.
An error window will declare that an error occurred during
restore. The restored file(s) may contain partial files and
possible corrupt information. We recommend that you correct
the files immediately.
Emergency Restore Procedure
Compressed files must be run through the restore to decompress the
files to their original condition.
In the event corrupted files are encountered during the restore,
you may "piece" files together using the DOS copy and concatenate
(+) command. Individual files on a single disk can be restored
with the DOS copy command. If a file is split across two backup
disks in a set, merge the two files by copying them to the hard
drive under new names using DOS commands.
For example, the file MYFILE.DAT was split across two disks. Copy
the first MYFILE.DAT file to another drive, such as 'C:', and
rename it in one DOS command:
1) COPY A:\MYFILE.DAT C:\MYFILE1.DAT
Insert the second disk containing the remainder of the file. Merge
the two pieces together by concatenating them to a new file that
will be a duplicate of the original file with the same name.
Page 10
2) COPY /B C:\MYFILE1.DAT + A:\MYFILE.DAT C:\MYFILE.DAT
You can concatenate a file spread over more than two disks by
repeating the above step multiple times. The /B switch tells DOS
that the file is binary. This avoids interpreting any ^Z as an
end-of-file marker.
Finally, erase the first part of MYFILE.DAT that is on drive C:
3) ERASE C:\MYFILE1.DAT
This operation is not recommended for novice DOS users. Use it
only in emergency conditions as a last resort method. Always keep
a copy of the restore program on a bootable floppy disk in case the
hard disk is damaged.
Error Handling
Simple Backup handles all critical and non-critical errors that
normally occur. An routine replaces the DOS critical error handler
interrupt. This tells DOS to ignore the error so it is handled
properly without the need to abort and re-execute. A critical
error is usually a hardware problem preventing function completion.
These errors range from trying to access a floppy drive with the
drive door open to attempting to write to a write protected disk.
A non-critical error is less serious, but may still prevent the
completion of a function. Non-critical errors include attempting
to delete a read only file or attempting to remove a directory
containing files. Both critical and non-critical errors are
reported in the same manner. You are then asked to select an
action based on the severity and "correctability" of the error. In
the case of the open drive door, closing the door and selecting
retry corrects the error. When an error occurs, you usually may
choose retry, abort, or continue. The continue option may be used
if a file cannot be restored. Here the file is skipped and the
next file, if any, is processed. Occasionally, an uncorrectable
error exists. Here you are informed of the error and asked to
press a key to continue. The key response is used only to end the
error message display.
Common disk error messages, their probable causes, and possible
actions:
Page 11
Access denied
Causes: This error can occur for many reasons. An attempt to
delete a read only file, an attempt to remove a directory that is
not empty, or an attempt to overwrite a read only file.
Responses: Repeated attempts performing an illegal DOS operation
will not be successful. The continue response, if the file is one
of many, is usually the only valid response.
Data error (CRC)
Causes: This error means that there is an error in the file header
and that the file is probably not recoverable, at least not in it's
entirety. This can be caused by an error while writing the file or
by one of many kinds of physical damage to a floppy disk.
Responses: You may select continue if this error occurs during a
batch operation, or abort. Retrying will not usually recover the
file. There are specialty programs that attempt to recover damaged
files and such a function is not within the scope of Simple Backup.
Disk write protected
Causes: There is only one possible cause for this error -
attempting to write to a write protected disk.
Responses: Remove the write protection from the disk and select
retry. Be sure that you know why the disk was write protected
before removing the protection. You may be defeating the purpose
of the write protection. You may elect to abort if you choose not
to remove the write protection. The continue response is not valid
here.
Drive not ready
Causes: This is probably the most common of critical errors. It
can be caused by an attempt to read or write to a floppy drive with
the drive door open. It also can be caused by an attempt to read
or write disk media not consistent with the drive type such as
trying to read a 1.2M disk in a 360K floppy drive. An unformatted
disk will produce the same error. A less common cause would be
attempting to read or write to a floppy disk inserted upside down
in the drive. If this error occurs while reading or writing to a
hard drive, the drive may be in need of service.
Responses: This error, while serious to DOS, is usually easily
corrected by closing the drive door or replacing the disk with one
consistent with the drive type. If the cause can be corrected,
select retry, otherwise select abort.
Page 12
File not found
Causes: This error should only occur when a floppy disk is changed
during processing.
Responses: Insert the proper disk and select retry, or abort
processing.
Insufficient memory
Causes: You do not have enough system memory to complete a function
and probably not enough memory to continue with Simple Backup.
Responses: You may have drivers or TSR's (terminate and stay
resident programs) in memory that do not leave enough memory to run
Simple Backup. The general action is to free up memory by
running Simple Backup in a different manner or removing some TSR's or
device drivers.
For example, if you run Simple Backup from inside some programs, you
do not have as much free memory to start work with as if you
started the program from the DOS prompt.
Path not found
Causes: This can occur if the drive or path entered is an invalid
drive or path specification or does not exist.
Responses: Select retry if the error can be corrected. Enter a
new, valid drive and path specification or, if a floppy
drive,insert the disk with the specified path and press 'R'. If
the error cannot be corrected, select abort.
Read fault
Causes: These errors are unclear and can be caused by any or all of
the above errors. The most likely candidate would again be the
media, but there are many other possibilities.
Responses: Try another disk or drive. Repeated failure could
suggest that the drive requires service.
Sector not found
The causes and responses for this error would be the same as the
Data error (CRC).
Page 13
Seek error
Causes: This error is similar to a Data error (CRC) except that it
is usually more hardware oriented.
Responses: If this error occurs on a hard drive, the drive may be
in need of service. If the drive is a floppy drive, try another
disk to backup or restore. Usually abort is the only possible
response.
Too many files open
Causes: This error is caused by an improper system configuration.
Response: If this error occurs:
1) Exit the application.
2) Edit your config.sys file. Increase the number of files that
can be opened at one time. This command is "files=nnn" where
nnn is the maximum number of open files.
3) Re-boot your computer.
Unknown media type
Causes: The function attempted to read or write to a disk with a
media type inconsistent with the drive type.
Responses: If the unknown media can be replaced with media of the
proper type, select retry. If not, select abort. Continue is not
a valid response here.
Unknown error
Causes: This is included when DOS has no explanation for the events
that have occurred. If DOS has no explanation, we cannot provide
one here.
Responses: It is probably best to abort the operation and start
over.
There are many other less likely DOS errors. More information on
the subject of DOS errors can be obtained in your DOS manual, if
needed.
Page 14
Help System
SIMPBACK.HLP and SIMPREST.HLP are ASCII files read by Simple Backup
and paged in the help window. The help files should be in the same
directory as the Simple Backup program. However, Simple Backup can
search available drives for the help files when it is not found in
the default directory. The help system uses a "where is" type of
search for the help file, starting with the first hard drive. When
the help file is found, it is displayed. The directory where the
help file was found is saved for later calls to the help system.
Language File
There is a language file called SIMPBACK.LNG. This file must be in
the current directory when Simple Backup is run or a drive search is
performed. If the file is not found the program is terminated.
Technical Support
Registered users may obtain technical support at no cost for a
period of 6 months from date of registration. Non-registered users
may obtain additional product information, but will not be provided
advanced technical support.
Thrifty Applications can also be reached by phone. The
number is (612) 593-5019. You can reach us at:
Thrifty Applications
P.O. Box 5603
Hopkins, MN 55343
or
ComuServe at 72371,2444
Page 15